home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / archiver / ltarv3.zip / LTAR.DOC < prev    next >
Text File  |  1992-01-28  |  4KB  |  107 lines
  1. Program :
  2.     LTAR
  3.  
  4. Usage :
  5.     LTAR [bxvt|f tarfile|g maptable|l dir-length|r rand-no-factor]
  6.     one of b, x, t options must be supplied w/ f option.
  7.     one of b, x option must be supplied w/ f and g options
  8.     b := build map file of tarfile w/o extracting
  9.     x := extract file in tarfile
  10.     v := verbose mode
  11.     t := full table list
  12.     f tarfile := assign tape archive file (U*IX's *.tar)
  13.     g maptable := the mapping table recorded converted-filename from *.tar
  14.     l dir-length := reduce the length of extracted filename (see Examples.)
  15.     r rand-no-factor := user-defined random seed for filename converting
  16.         (see Examples.)
  17.  
  18. Description :
  19.  
  20.     LTAR provides new consideration of detaring U*IX's *.tar into DOS
  21. file system, i.e., a well-considered policy (schema) is applied for this
  22. purpose. By creating a mapping table file (you can type this map file),
  23. we can inspect these files via another assistant utility TARV (See TARV.DOC
  24. tar viewer). The converting policy is simple, and just only a hashing function
  25. plus seeded-random number. To understand the detail information, please study
  26. the C source code of LTAR.
  27.  
  28.     Special compatibility is U*IX's file link, I just copy the linked
  29. filename as the content of link file. Another one is that DOS only support
  30. 62 characters for path, and I put `l option' to short U*IX's 256 characters
  31. filename.
  32.  
  33.     N.B. Any key-pressing will be recognized and will abort the
  34. operation of LTAR, i.e., if you want to stop immediately, just hit a key.
  35.  
  36. Examples:
  37.  
  38.     (1):-    LTAR tvf x.tar
  39.     /* same as U*IX's tar tvf x.tar
  40.     */
  41.  
  42.     (2):-    LTAR xf x.tar g x.map
  43.     /* same as U*IX's xf x.tar but ltar will print some dots `.' to tell
  44.        you it is working as well as creating a map file x.map
  45.     */
  46.  
  47.     (3):-    LTAR xvf x.tar g x.map
  48.     /* same as U*IX's xvf x.tar and create a map file x.map
  49.     */
  50.  
  51.     (4):-    LTAR xtf x.tar g x.map
  52.     /* there is no equivalent U*IX command, due to this feature is a samll
  53.        quirk (or bug)
  54.     */
  55.  
  56.     (5):-    LTAR bvf x.tar g x.map
  57.     /* If you lost the x.map (deleted carelessly), you do not need detar
  58.        x.tar again, just use b option to rebuild (or re-scan x.tar)
  59.        mapping table.
  60.     */
  61.  
  62.     (6):-    LTAR xvf x.tar g x.map l 1
  63.     /* Reduce converted filename's directories length, suppose there is a
  64.        file in x.tar:
  65.        This-is-a/very-long/path-with/several-levels-of-dirs/how-can/I-do-huh
  66.        as you see, if you do not support `l option', it will be mapped into
  67.        This-is-.XXX/very-lon.XXX/path-wit.XXX/several-.XXX/how-can.XXX/I-do-huh.XXX
  68.        yes, it is too long! So, I provided `l option', and after applyoing
  69.        `l 1' and this filename will be mapped as
  70.        T.XXX/v.XXX/p.XXX/s.XXX/h.XXX/I.XXX/d.XXX/I-do-huh.XXX
  71.        then it is accepted by DOS.
  72.        (N.B. XXX is a 3 digits of hexidecimal number.)
  73.     */
  74.  
  75.     (7):-    LTAR xvf x.tar g x.map r 5
  76.     /* let's suppose x.tar's content is:
  77.        x.tar:
  78.         drwxrwxrw- 0/0         0 Jan 27 08:48 1992 t/
  79.         -r-xr-xr-- 0/0         2 Jan 27 08:48 1992 t/--------ABC
  80.         -r-xr-xr-- 0/0         4 Jan 27 08:49 1992 t/--------BAC
  81.         -r-xr-xr-- 0/0         4 Jan 27 08:49 1992 t/--------CBA
  82.        and if we do not provide `r option' and `ltar xvf x.tar g x.map' :
  83.        x.map:
  84.         t/ t.074\
  85.         t/--------ABC t.074\--------.0C6
  86.         t/--------BAC t.074\--------.0C6
  87.         t/--------CBA t.074\--------.0C6
  88.        well, you can see that I just only summed up each character's ASCII
  89.        code of filename. In hashing theory, this situation is called
  90.        `collision', we must provide another factor to distingush amoung
  91.            different files. After applying `r 5' option, i.e.,
  92.        `ltar xvf x.tar g x.map r 5', now x.map is :
  93.        x.map:
  94.         t/ t.074\
  95.         t/--------ABC t.074\--------.352
  96.         t/--------BAC t.074\--------.358
  97.         t/--------CBA t.074\--------.46D
  98.        If you wish, you can modify the source code and let this schema
  99.        perform as default hashing schema.
  100.     */
  101.  
  102.     (8):-    other similar examples:
  103.         LTAR bvf x.tar g x.map r 5
  104.         LTAR bf x.tar g x.map l 1
  105.         LTAR btf x.tar g x.map l 1 r 5
  106.         etc.
  107.